//
//  NSString+LYAdd.h
//  LYDevelopKit
//
//  Created by 李阳 on 2018/5/26.
//

#import <Foundation/Foundation.h>

@interface NSString (LYAdd)

#pragma mark - Utilities

/// 获取字符串(或汉字)首字母
- (NSString *)firstCharacter;

/// 按字符串中数字和.出现的顺序保留数字和.
- (NSString *)retenteOfNumbers;

/// 保留 `setString` 中出现的字符
- (NSString *)retenteWhenOccurrencesInSet:(NSString *)setString;

/// 生成到指定字符的字符串
- (NSString *)subStringToString:(NSString *)str;
/// 生成从指定字符开始的字符串
- (NSString *)subStringFromString:(NSString *)str;
/// 移除str
- (NSString *)removeString:(NSString *)str;

- (NSString *)substringFromString:(NSString *)fromString toString:(NSString *)toString;

- (void)enumerateSequenceCharacterUsingBlock:(void (^)(NSString *string, NSRange range, BOOL *stop))block;


#pragma mark - Encode and decode

/// 表情编码
- (NSString *)stringByEmojiEncode;
/// 表情解码
- (NSString *)stringByEmojiDecode;


#pragma mark - Regular

/// 是否匹配 `regular` 正则表达式
- (BOOL)matchesRegular:(NSString *)regular;

/// 邮箱验证
- (BOOL)isEmail;
/// 手机号验证
- (BOOL)isPhoneNo;

/// 是否包含emoji
- (BOOL)containsEmoji;

/// 是否包含九宫格数字"➋➌➍➎➏➐➑➒☻"
- (BOOL)containsSudokuNumber;

@end



/**
 对浮点数进行取舍

 @param decimal 浮点数
 @param precision 要保留的小数位数
 @return 返回截取后的字符串
 */
FOUNDATION_EXTERN NSString *Round(CGFloat decimal, int precision);


/**
 *  正则表达式简单说明
 *  语法：
 .       匹配除换行符以外的任意字符
 \w      匹配字母或数字或下划线或汉字
 \s      匹配任意的空白符
 \d      匹配数字
 \b      匹配单词的开始或结束
 ^       匹配字符串的开始
 $       匹配字符串的结束
 *       重复零次或更多次
 +       重复一次或更多次
 ?       重复零次或一次
 {n}     重复n次
 {n,}     重复n次或更多次
 {n,m}     重复n到m次
 \W      匹配任意不是字母，数字，下划线，汉字的字符
 \S      匹配任意不是空白符的字符
 \D      匹配任意非数字的字符
 \B      匹配不是单词开头或结束的位置
 [^x]     匹配除了x以外的任意字符
 [^aeiou]匹配除了aeiou这几个字母以外的任意字符
 *?      重复任意次，但尽可能少重复
 +?      重复1次或更多次，但尽可能少重复
 ??      重复0次或1次，但尽可能少重复
 {n,m}?     重复n到m次，但尽可能少重复
 {n,}?     重复n次以上，但尽可能少重复
 \a      报警字符(打印它的效果是电脑嘀一声)
 \b      通常是单词分界位置，但如果在字符类里使用代表退格
 \t      制表符，Tab
 \r      回车
 \v      竖向制表符
 \f      换页符
 \n      换行符
 \e      Escape
 \0nn     ASCII代码中八进制代码为nn的字符
 \xnn     ASCII代码中十六进制代码为nn的字符
 \unnnn     Unicode代码中十六进制代码为nnnn的字符
 \cN     ASCII控制字符。比如\cC代表Ctrl+C
 \A      字符串开头(类似^，但不受处理多行选项的影响)
 \Z      字符串结尾或行尾(不受处理多行选项的影响)
 \z      字符串结尾(类似$，但不受处理多行选项的影响)
 \G      当前搜索的开头
 \p{name}     Unicode中命名为name的字符类，例如\p{IsGreek}
 (?>exp)     贪婪子表达式
 (?<x>-<y>exp)     平衡组
 (?im-nsx:exp)     在子表达式exp中改变处理选项
 (?im-nsx)       为表达式后面的部分改变处理选项
 (?(exp)yes|no)     把exp当作零宽正向先行断言，如果在这个位置能匹配，使用yes作为此组的表达式；否则使用no
 (?(exp)yes)     同上，只是使用空表达式作为no
 (?(name)yes|no) 如果命名为name的组捕获到了内容，使用yes作为表达式；否则使用no
 (?(name)yes)     同上，只是使用空表达式作为no
 
 捕获
 (exp)               匹配exp,并捕获文本到自动命名的组里
 (?<name>exp)        匹配exp,并捕获文本到名称为name的组里，也可以写成(?'name'exp)
 (?:exp)             匹配exp,不捕获匹配的文本，也不给此分组分配组号
 零宽断言
 (?=exp)             匹配exp前面的位置
 (?<=exp)            匹配exp后面的位置
 (?!exp)             匹配后面跟的不是exp的位置
 (?<!exp)            匹配前面不是exp的位置
 注释
 (?#comment)         这种类型的分组不对正则表达式的处理产生任何影响，用于提供注释让人阅读
 
 *  表达式：\(?0\d{2}[) -]?\d{8}
 *  这个表达式可以匹配几种格式的电话号码，像(010)88886666，或022-22334455，或02912345678等。
 *  我们对它进行一些分析吧：
 *  首先是一个转义字符\(,它能出现0次或1次(?),然后是一个0，后面跟着2个数字(\d{2})，然后是)或-或空格中的一个，它出现1次或不出现(?)，
 *  最后是8个数字(\d{8})
 */
